Installing CFX2 on linux

- login to linux
- startx - starts the linux GUI. Your GUI may be 
  different, or you may simply be using the command line.
- Install Java SDK
  - Go to url http://java.sun.com/j2se/downloads.html
  - Download and install rpm (for RedHat) or tar.gz (for general UNIX), 
    full version. 
	- to install an rpm,      use: rpm -i <file>.rpm
	- to install from tar/gz, use: tar xvfpz <file>.tat.gz
  - create directory /etc/java
  - edit /etc/java/java.conf, add line: JAVA_HOME=/usr/java/jdk1.4.1
    The jdkx.x.x should reflect the version of Java you are actually installing.

- Install MySql (standard) 4.0
  - Go to http://www.mysql.com/downloads/
    or to http://mirror.sit.wisc.edu/mysql/downloads/mysql-4.0.html
  - download the one tar.gz (for general UNIX), or the set of ~6 rpms (for RedHat)
  - install/untar to /usr/local/
  - read the mysql manual to set up mysql server. The sections mentioned belowd:
    - Sections 2.1, M.1, 2.4, 2.4.3 - to setup
    - Sections 4.3.4, 4.3.5 - to add users
  - Add a root@*, root@localhost, root@abc.edu
    user@*, user@localhost, user@abc.edu
  - to start the mysql server, type: 
     <mysqldir>/support_files/mysql.server start

- Install MySql CC GUI
  - download from http://www.mysql.com/downloads/mysqlcc.html
  - start mysql server
  - open the GUI
  - connect to the mysql database using the root/user password
  - Create a blank database, and name it CFX2
  - open a query window
  - open file CFX2<Date>.sql in the query window 
    (e.g.CFX2May26.sql). This is the CFX file containing sample data that we 
    currently have.
  - For GUI-less Unix, refer to the mysql manual on how to import the contents 
    of a .sql file into the database

- Install Tomcat4
  - Go to http://jakarta.apache.org/site/binindex.cgi
    or to http://ftp.epix.net/apache/jakarta/tomcat-4/binaries/
  - download and install the full edition 
  - tomcat4 installs to the following directories:
     /var/tomcat4
     /etc/tomcat4
     /usr/share/doc/tomcat4.1.24
     /usr/bin/tomcat4
  - open tomcat4.conf, check if the following are set  correctly
     CATALINA_HOME=/var/tomcat4
     JASPER_HOME=/var/tomcat4
     CATALINA_TMPDIR=/var/tomcat4/tmp
  - start tomcat to test it. type,
     /usr/bin/tomcat4 [start/stop] &
  - browse to http://localhost:8080 in your browser
  - if the tomcat page doesn't load, something was done incorrectly!

  - open server.xml from the tomcat4 directory. Make changes
    to it based on the sample server.xml file included with this installation
  - add a <Context> element after the Context element for
    "examples". It goes like this:
	 <Context path="/CFX2" docBase="CFX2" ...>
  - copy the local CFX2 directory into /var/tomcat4/webapps/
  - give write & execute permissions to all files in the CFX2 directory
  - edit /var/tomcat4/webapps/CFX2/WEB-INF/web.xml - set MySql user name 
    and password so that CFX2 can access the database.
  - change Mysql root/user and the corresponding password
  - restart tomcat4
  - browse to 
      http://localhost:8080/CFX2/MainUI.jsp   <from windows> 
      http://localhost:8080/CFX2/NSMainUI.htm <from linux>

- Troubleshooting
  - if http://<yourhost>:<yourport>/CFX2/servlet/HelloWorld doesn't work,
    check internet connection, dhcp setup